home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr15 / gifexe41.zip / GIFEXE.DOC < prev    next >
Text File  |  1993-06-09  |  18KB  |  457 lines
  1.  
  2.   
  3.  
  4.                            G I F E X E 
  5.  
  6.                            Version 4.1
  7.                           June 9 , 1993   
  8.       
  9.           A Self-Displayer and Slideshow Program for Your        
  10.                         GIF(tm) Pictures 
  11.             Copyright 1990,1993 Synergrafix Consulting 
  12.                        All right reserved.  
  13.     
  14.      GIFEXE is produced by: 
  15.  
  16.            Steve Enns                  Synergrafix Consulting  
  17.         44 Macdermid Cres.    and        44 Macdermid Cres.
  18.           Saskatoon, Sk.                   Saskatoon, Sk.  
  19.           Canada S7J 2R2                   Canada S7J 2R2  
  20.  
  21.      Okay, here's the boring stuff, but don't worry, it's better
  22.      than chewing tinfoil: 
  23.  
  24.  
  25. ACKNOWLEDGEMENTS 
  26.  
  27.      Kudos, thanks, and good karma to John Bridges for the 
  28.      enlightening information and code contained in his VGAKIT 
  29.      package.  Trademarks like GIF(tm) and PC(tm) are held by 
  30.      their respective companies.  
  31.  
  32.  
  33. DISCLAIMER 
  34.  
  35.      The GIFEXE program is provided without warranty of any      
  36.      kind.  The user of the GIFEXE assumes complete              
  37.      responsibility for any and all incidental or consequential  
  38.      damages which may occur during normal or abnormal use of the
  39.      GIFEXE program.  Use the GIFEXE program at your own risk. 
  40.  
  41.  
  42. LICENSE  
  43.   
  44.      The entire GIFEXE package, including the GIFEXE program, 
  45.      documentation, and sample files are Copyright 1990,1993 
  46.      Synergrafix Consulting.  All rights reserved.  The          
  47.      unregistered shareware version of the GIFEXE may be freely 
  48.      distributed to others by any means, as long the following 
  49.      (three) conditions are met: 
  50.  
  51.           1) GIFEXE is distributed in a "package" containing     
  52.           the following three files: 
  53.                               GIFEXE.EXE 
  54.                               GIFEXE.DOC 
  55.                               GE-READ.ME 
  56.            
  57.           2) GIFEXE is not distributed as part of any other      
  58.           product, except with specific written permission from 
  59.           the author, Steve Enns.  
  60.  
  61.           3) NO fee of any kind is charged for the GIFEXE        
  62.           package or for the service of providing the package,   
  63.           except Computer Bulletin Board Systems, which may      
  64.           distribute the GIFEXE package even though they may     
  65.           charge a membership or service fee.   
  66.  
  67.      You can use the "shareware" version for as long as you 
  68.      want, even until you're well into your nineties, but you are
  69.      of course encouraged to send us lots of money, too. (I'm 
  70.      struggling to pay for my violin lessons, and Dan needs a new
  71.      fishing rod.)  If you send $8.00 U.S. or more to the "Steve
  72.      Enns" guy above, you will receive a 5.25" disk (3.5"        
  73.      disks are $2.00 extra) with the latest registered version of
  74.      GIFEXE, which has several additional "special effects"
  75.      features, and can make slideshows from an unlimited number of
  76.      GIFs. (See below.)  If you send $23.00 U.S. or more, you    
  77.      will also receive registered versions of the following      
  78.      programs: 
  79.  
  80.           GIFWARP!       Warp, bend stretch your GIFs for 
  81.                          interesting effects. 
  82.  
  83.           GIFCLIP        Clip/crop your GIFs, add text or your 
  84.                          own GIF logo or signature. 
  85.            
  86.           GIFSIZE        Resize all or part of your GIFs.  Shrink
  87.                          an entire screen to the size of an icon.
  88.  
  89.      (These programs are available in licensed SuperVGA versions
  90.      for $8.00 U.S. each, or get all three, and the latest 
  91.      version of GIFEXE for $23.00 U.S. or more.  The registered
  92.      versions may not be distributed to others, or distributed
  93.      with, or as part of any other product.) 
  94.  
  95.  
  96. REQUIREMENTS 
  97.  
  98.           GIFEXE requires the following: 
  99.  
  100.                -    PC(tm)/XT(tm)/AT(tm)/386(tm) computer thing 
  101.                -    About 280K of free RAM 
  102.                -    DOS 3.0-6.0 (others untested)
  103.                -    A VGA or SuperVGA card 
  104.                -    Some GIF(tm) pictures.
  105.  
  106.           and optionally: 
  107.  
  108.                -    GIFEXE supports modes like 640x480, 800x600,
  109.             1024x768 with 256 colours on 512K and 1024K
  110.             SuperVGA cards from ATI, Ahead, Cirrus, Chips
  111.             and Technologies, Everex, OAK, Paradise, Trident,
  112.                     Tseng, Video7, Compaq, NCR, Genoa and VESA. 
  113.             S3 based cards that have a (bug-free!) VESA
  114.             bios are also supported.    
  115.  
  116. INSTALLATION 
  117.  
  118.      Copy the GIFEXE program (and this helpful document of 
  119.      course!) to any directory that you want - perhaps with      
  120.      your favourite GIF(tm) viewer somewhere in the DOS          
  121.      path. 
  122.       
  123.  
  124. USAGE 
  125.  
  126.      Syntax for GIFEXE is as follows: 
  127.  
  128.           GIFEXE [?] infilename[.GIF] [outfilename[.EXE]] 
  129.                     /mode=0,1,2..  /autoscale 
  130.  
  131.      to make a single GIF display program, or 
  132.  
  133.           GIFEXE [?] @listfile [outfilename[.EXE]] 
  134.                     /stopkey=n  /cycle=0,1,2,3
  135.  
  136.      to make a slideshow program.
  137.  
  138.      In addition, the following "special effects" options
  139.      are available in the registered version:
  140.  
  141.             /fadein [ /fadeout | /dissolve ]  /delay=secs /noclear
  142.  
  143.      Generally, the options may be used with GIFEXE when you are
  144.      creating an EXE, or with the EXE that you have already
  145.      created.  When using a list file to make an EXE slideshow,
  146.      the special effects options are placed in the list file. (See
  147.      TUTORIAL below.) 
  148.  
  149.      The options are as follows: 
  150.  
  151.      /mode=code     /mode=0        Ordinary 320x200 mode 
  152.                     /mode=1        Low resolution SVGA 
  153.                                         640x400 or 640x350 
  154.                                         depending on your card. 
  155.                     /mode=2        Medium resolution 640x480 
  156.                     /mode=3        High resolution 800x600  
  157.                     /mode=4        Higher resolution 1024x768 
  158.                                         is supported on some 
  159.                                         1024K cards. Try a VESA
  160.                     driver!) 
  161.                     /mode=5        Higher-still resolution 
  162.                     1280x1024 for VESA.
  163.                      
  164.      /autoscale     When this switch is used, the GIF will be 
  165.                     scaled up to fit on the screen if the screen
  166.                     resolution is 2 or more times the resolution
  167.                     of the GIF.  (Just try it with a 320x200 GIF
  168.                     and a 640x480 screen mode.) 
  169.      
  170.  
  171.      When using a list file to make a slideshow:
  172.  
  173.      /cycle=code    /cycle=0       Play the slideshow once,      
  174.                                    forward
  175.                     /cycle=1       Play the slideshow forward,
  176.                                    continuously
  177.                     /cycle=2       Play the slideshow backward,
  178.                                    continuously
  179.                     /cycle=4       Play the slideshow backward,
  180.                                    once
  181.      /stopkey=code  /stopkey=27    Play the show until ESC key   
  182.                                    (ascii 27) is hit. Default.
  183.                     /stopkey=32    Play until spacebar is hit
  184.           
  185.      And the additional "special effects" available in the
  186.      registered version: 
  187.       
  188.      /fadein        Gradually fade in when displaying the GIF.  
  189.                     The screen will start black, and gradually 
  190.                     the pictures will appear as the colors 
  191.                     brighten. 
  192.  
  193.      /fadeout       After the GIF has been displayed, and the  
  194.                     program is going to exit after a keypress, 
  195.                     or a delay (see below) the screen will 
  196.                     gradually fade to black. 
  197.  
  198.      /dissolve      After the GIF has been displayed, and the 
  199.                     program is going to exit, the pixels will 
  200.                     randomly turn black until the entire picture
  201.                     is gone. 
  202.  
  203.      /delay=secs    After the GIF has been displayed, wait "secs"
  204.                     seconds before automatically exiting.  The 
  205.                     program will also exit if a key is pressed 
  206.                     before the time has expired. 
  207.  
  208.      /noclear       The screen will not be cleared when the program
  209.                     exits.  This is useful if you are using GIFEXE
  210.                     to display an image from a program, and want to
  211.                     leave the image on the screen after the user
  212.                     presses the exit key.
  213.  
  214.      /bouncein      "Bounce" the image onto its position on the 
  215.                     screen.  This effect works best with images
  216.                     that are not as tall as the entire screen - 
  217.                     a GIF image that is 100 pixels high works well
  218.                     for ordinary VGA 320x200 mode, for example.
  219.  
  220.      /bounceout     "Bounce" the image off the screen.  See /bouncein
  221.                     above.
  222.  
  223.      /pass=str      Display the image only if the user has the correct
  224.                     password.  The password is specified on the command
  225.                     line when making the EXE file, and the user is prompted
  226.                     for the password when the image is about to be displayed.
  227.                     If the password is not given, or is incorrect, the image
  228.                     will not be displayed.  This allows "secret" pictures 
  229.                     in a slideshow, for example.  (The password applies to
  230.                     only the current picture. If an entire slideshow is to
  231.                     be protected, then each image will have to specify this
  232.                     option in the list file.  See below.)  The passwords
  233.                     are NOT case sensitive - "password" is considered equal
  234.                     to "PassWord".
  235.  
  236.      When using a list file to make a slideshow, the listfile    
  237.      has the following format:
  238.  
  239.           file1[.gif] /fadein /delay=n /fadeout /mode=m /autoscale /pass=steve
  240.           file2[.gif] ...
  241.           .
  242.           .
  243.           .
  244.           filen[.gif] ...
  245.  
  246.      (One GIF filename with the desired display options on each
  247.      line of the file.  The unregistered version is limited to five
  248.      images in a list file.  The registered version should be    
  249.      able to do several thousand, in case you have the disk space
  250.      and inclination to make a 100 Megabyte slideshow.
  251.                                               
  252.  
  253.      For example, try: 
  254.  
  255.           C> GIFEXE                to see the title screen 
  256.  
  257.           C> GIFEXE ?              to see the help/brag screen 
  258.  
  259.           C> GIFEXE house          to make the .EXE HOUSE.EXE 
  260.                                    from the file HOUSE.GIF   
  261.  
  262.           C> GIFEXE house house2 /autoscale /fadein 
  263.                                    make the .EXE file HOUSE2.EXE,
  264.                                    from the GIF(tm) HOUSE.GIF 
  265.                                    using autoscale and fadein, so
  266.                                    that HOUSE2 will fadein and 
  267.                                    autoscale when run. (/fadein 
  268.                                    available on registered 
  269.                                    versions only.) 
  270.  
  271.           C> GIFEXE house /delay=10  
  272.                                    make an EXE, HOUSE.EXE which 
  273.                                    will display HOUSE.GIF and 
  274.                                    then wait 10 seconds before 
  275.                                    exiting. 
  276.  
  277.           C> GIFEXE @list /cycle=1 /stopkey=32 
  278.                                    make an EXE, LIST.EXE of the GIF
  279.                                    in the listfile LIST, which   
  280.                                    will play in a loop until the
  281.                                    spacebar (ascii 32) is pressed.
  282.                                    The first image will fadein,
  283.                                    wait 2 seconds and then continue
  284.                                    to the next image. The file   
  285.                                    LIST contains:
  286.                          
  287.                                         gif1 /fadein /delay=2
  288.                                         gif2
  289.                                         gif3
  290.                                         gif4
  291.  
  292.           C> GIFEXE secret.gif /pass=pokey
  293.                                    Make SECRET.EXE from SECRET.GIF,
  294.                                    using the password "POKEY". 
  295.  
  296. TUTORIAL 
  297.  
  298.      (Nothin' to it!) 
  299.  
  300.      Try out the following with your favourite GIF(tm) picture: 
  301.  
  302.                C> GIFEXE picturename 
  303.  
  304.      GIFEXE will prduce an EXE program with the name 
  305.      "picturename.EXE"  That's it!   Now just run the program 
  306.      you've just made: 
  307.  
  308.                C> picturename 
  309.  
  310.      The picture will be displayed on your screen in VGA, or in 
  311.      SuperVGA if your computer has SuperVGA, and the picture 
  312.      requires it.  If you want a small (VGA) picture to be 
  313.      displayed in SuperVGA resolution, try: 
  314.  
  315.                C> picturename /mode=2 
  316.  
  317.      to display the picture in medium SuperVGA resolution.  If 
  318.      you have the registered version, you can make an EXE that 
  319.      will "fade in", and "dissolve out": 
  320.  
  321.                C> GIFEXE picturename /fadein /dissolve  
  322.  
  323.      Now when you run picturename, 
  324.  
  325.                C> picturename 
  326.  
  327.      The picture will "fade in", wait for a keypress, and  
  328.      then "dissolve" and the program will exit.  And even if you
  329.      didn't use some options when you created picturename.EXE, 
  330.      you can still use them later.  Try: 
  331.  
  332.                C> picturename /delay=10 /mode=3 
  333.  
  334.      and then the picture will "fade in" using mode 3, wait for 
  335.      10 seconds or a keypress, and then "dissolve" and exit. 
  336.      
  337.      To make an automated slideshow, make the following file
  338.      (GIFSHOW.LST) with your text editor and your own GIF
  339.      filenames:
  340.  
  341.            gifname1 /fadein /delay=2 /fadeout
  342.            gifname2 /delay=2
  343.            gifname3 /delay=2
  344.            gifname4 /delay=2
  345.            gifname5 /delay=2 /fadeout
  346.  
  347.      Now, use the following GIFEXE command:
  348.  
  349.           C> GIFEXE @gifshow.lst /cycle=1
  350.  
  351.      The file GIFSHOW.EXE will be produced, which will display the
  352.      five images in your slideshow, continuously, until the ESC key
  353.      is pressed:
  354.  
  355.           C> gifshow
  356.  
  357.      You can play the show backwards, until the spacebar is hit by
  358.      changing the cycle and stopkey parameters:
  359.  
  360.           C> gifshow /cycle=3 /stopkey=32
  361.  
  362.      If you omitted the /delay parameters in the list file, each
  363.      GIF would be displayed until a key was pressed, or the
  364.      slideshow was aborted with the ESC or /stopkey. 
  365.  
  366.  
  367. HINTS 
  368.  
  369.      - The EXEs produced by GIFEXE are handy for startup screens
  370.      on your computer, or title screens for your programs. 
  371.  
  372.      - Since version 3.0, self-running slideshows of GIFs may be
  373.      produced without using batch files.  If you are using DOS 5.0,
  374.      there is an easy way to make a list file for slideshows:
  375.  
  376.           C> dir /b *.gif > listfile
  377.  
  378.      "listfile" will now contain the names of all the GIFs in the
  379.      current directory.  You can then just add the desired options
  380.      to each line of the "listfile", and the make the slideshow:
  381.  
  382.       C> gifexe @listfile
  383.  
  384.  
  385. ERRORS 
  386.  
  387.      - The following self explanatory error messages may be 
  388.      produced by GIFEXE.  The errors involving the GIF(tm) files
  389.      will generally be due to disk errors or faulty image files. 
  390.      Other errors refer to lack of enough free RAM space, or lack
  391.      of required hardware (VGA). 
  392.  
  393.           Can't initialize VGA graphics! 
  394.           Unexpected EOF reading GIF! 
  395.           Premature end of GIF! 
  396.           Not GIF file! 
  397.           Invalid GIF format 
  398.           Error writing GIF! 
  399.           Buffer allocation failure! 
  400.            
  401.  
  402. NOTES 
  403.  
  404.      - GIFEXE reads both GIF87A standard (the original) and      
  405.      new GIF89A pictures, although most of the extensions in the
  406.      new GIF89A standard like (silly) text windows are ignored. 
  407.      The last image in multi-image GIFs will be the one displayed
  408.      by GIFEXE. 
  409.   
  410.  
  411. HISTORY 
  412.  
  413.      - Version 1.0 Completed June.1 1991 
  414.       
  415.      - Version 1.2 Completed Sep.15 1991 
  416.           Some additional cards now supported.  1024x768x256 now
  417.           supported on some 1024K cards. 
  418.  
  419.      - Version 2.0 Completed Sep.20 1991 
  420.           Registered version introduced with /fadein /fadeout 
  421.           /dissolve /delay options.  /autoscale option           
  422.           added to both versions. 
  423.  
  424.      - Version 3.0 Completed Oct.1 1991
  425.           Multiple GIF EXE slideshows may now be produced.
  426.  
  427.      - Version 3.1 Completed Oct.4 1991
  428.           Ahhhhhh!!!!  Fixed INCREDIBLY STUPID bug that would cause
  429.           GIFEXE to abort if the picture was too big for the
  430.           screen.  Fixed bug that wouldn't allow full pathnames for
  431.           input files on the command line.
  432.  
  433.      - Version 3.2 Completed Feb.14 1993
  434.           Added /noclear option to registered version.
  435.  
  436.      - Version 4.0 Completed May 20 1993
  437.       More graphics support for newer graphics hardware.  Much
  438.       better VESA support.  (If GIFEXE dosen't want to do high-
  439.       resolution on your video card, try loading a VESA driver!)
  440.       S3 and other Windows accelerator cards which support VESA
  441.       are now supported.
  442.       
  443.           New /bouncein,  /bounceout and /pass options.
  444.  
  445.      - Version 4.1 Completed June 9 1993
  446.           Ahhhhhhhhhhhhhhh!!!!!!! Noooooooo!!!!  Fixed second
  447.           INCREDIBLY STUPID bug in the VESA support for modes
  448.           greater than 640x480.
  449.           
  450.           Addition of 1280x1024 support for VESA.
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.